home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / programs / dizman12.zip / DIZMAN.DOC < prev    next >
Text File  |  1993-05-31  |  29KB  |  604 lines

  1. ╔═════════════════════════════════════════════════════════════════════════════╗
  2. ║ ┌──────────   ┌───── ┌────────── ┌────   ┌────  ┌──────────  ┌────    ┌───  ║
  3. ║ ┌───    ┌───   ┌───        ┌───  ┌───── ┌───── ┌───     ┌─── ┌─────   ┌───  ║
  4. ║ ┌───     ┌───  ┌───       ┌───   ┌─── ┌── ┌─── ┌───     ┌─── ┌───┌──  ┌───  ║
  5. ║ ┌───     ┌───  ┌───      ┌───    ┌───  ┌  ┌─── ┌──────────── ┌─── ┌── ┌───  ║
  6. ║ ┌───     ┌───  ┌───     ┌───     ┌───     ┌─── ┌───     ┌─── ┌───  ┌──┌───  ║
  7. ║ ┌───     ┌───  ┌───    ┌───      ┌───     ┌─── ┌───     ┌─── ┌───   ┌─────  ║
  8. ║ ┌───    ┌───   ┌───   ┌───       ┌───     ┌─── ┌───     ┌─── ┌───    ┌────  ║
  9. ║ ┌──────────   ┌───── ┌────────── ┌───     ┌─── ┌───     ┌─── ┌───     ┌───  ║
  10. ╚═════════════════════════════════════════════════════════════════════════════╝
  11.  
  12.           Documentation for DizMan v1.20, written 1993 by Stefan Kuhn.
  13.  
  14. ╔═════════════════════════════════════════════════════════════════════════════╗
  15. ║                        Short overview about DizMan                          ║
  16. ╚═════════════════════════════════════════════════════════════════════════════╝
  17.  
  18.       - DizMan writes the description found in the original FILE_ID.DIZ,
  19.         which becomes more and more part of any files in BBS,  into your
  20.         FILES.BBS!
  21.  
  22.       - DizMan can also write the resolution of several grafx formats to
  23.         your FILES.BBS!
  24.  
  25.       - DizMan  also  works on  several  sound-formats.  It writes their
  26.         internal songname to your FILES.BBS!
  27.  
  28. ╔═════════════════════════════════════════════════════════════════════════════╗
  29. ║                                Why DizMan?                                  ║
  30. ╚═════════════════════════════════════════════════════════════════════════════╝
  31.  
  32.       - DizMan's  great  advantage is that you always have access to the
  33.         original file-description  FILE_ID.DIZ  and therefore is no need
  34.         to accept any other description given later!  The  author's desc
  35.         is the best desc!
  36.  
  37.       - DizMan prevents your system from giving your users file-descrip-
  38.         tions like 'a very nice MOD' or 'a new utility'.
  39.  
  40.       - DizMan should  work  with  almost  every  bbs system that uses a
  41.         FILES.BBS list.
  42.  
  43.       - DizMan  is  high-configurable!  You  can add new archivers,  new
  44.         grafx- & sound-formats etc.
  45.  
  46.       - DizMan  comes  with a sample configuration,  which works on ARC/
  47.         ARJ/DWC/HA/HAP/HPK/HYP/LZH/PAK/SQZ/ZIP/ZOO archives, selfextrac-
  48.         ting ARJ/LZH/PAK/ZIP archives,  the BMP/GIF/JPG/LBM/MAC/MSP/PCX/
  49.         PIC/RLE/SCX  grafx  formats and the JMS/MOD/NST/S3M/SD4/STM/STS/
  50.         669 (also FastTracker's 6 and 8 channel format) sound formats.
  51.  
  52. ╔═════════════════════════════════════════════════════════════════════════════╗
  53. ║                                 Note...  :-)                                ║
  54. ╚═════════════════════════════════════════════════════════════════════════════╝
  55.  
  56.              I am reliable for NOTHING that happens to your system!
  57.  
  58.              You  are  not  allowed  to use DizMan in an commercial
  59.              environment. Any site with  4  or  more  lines,  which
  60.              charges  money  for  the  actual  access to the BBS or
  61.              which  is  located  in  a  commercial  environment  is
  62.              considered commercial.
  63.  
  64. ╔═════════════════════════════════════════════════════════════════════════════╗
  65. ║                                 REGISTRATION                                ║
  66. ╚═════════════════════════════════════════════════════════════════════════════╝
  67.  
  68.  DizMan is not a Public Domain program and is not free! It's ShareWare!
  69.  
  70.  Non-registered users of this program are granted a limited 30-days license to
  71.  DizMan to evaluate the programs suitability for their requirements. Any usage
  72.  of  DizMan  beyond  the  evaluation time period requires registration! Use of
  73.  non-registered  copies of DizMan  beyond  the  original  evaluation period is
  74.  prohibited.
  75.  
  76.  Registration Fee:
  77.  
  78.         Non-commercial users in Germany     DM   10,-
  79.         Commercial users in Germany         DM   20,-
  80.  
  81.         Other non-commercial users          US$  10,-
  82.         Other commercial user's             US$  20,-
  83.  
  84.  Note:  You have to poll the key from my system!  If you are not able to poll
  85.         the key you have to pay DM 5,- (US$ 5,-) more and I will send you the
  86.         key including the latest Version of DizMan.
  87.  
  88.  To register DizMan please transfer the money to
  89.  
  90.         Stefan Kuhn
  91.         Volksbank Passau-Freyung eG (Germany)
  92.         BLZ    : 740 900 00
  93.         Account: 4771 6
  94.  
  95.         Please write your full name, home address, BBS name,  FidoNet Address
  96.         and  the program name in the notes for  the receiver at the  transfer
  97.         form.
  98.  
  99.  Or send the money in an envelope to :
  100.  
  101.         Stefan Kuhn                        Stefan Kuhn
  102.         Stallerweg 12                      Stallerweg 12
  103.         8390 Passau-Rittsteig              94036 Passau-Rittsteig
  104.         Germany                            Germany
  105.  
  106.                                            (use this after 1.7.93)
  107.  
  108.  For further information you can contact me via NM:
  109.  
  110.         Stefan Kuhn
  111.  
  112.         2:246/222.0@FidoNet
  113.         9:494/6000.0@VIRNET
  114.         22:32/9.0@RockyNet
  115.         23:100/21.0@KultNet
  116.         94:510/301.0@CDN
  117.  
  118.  After receiving  your  registration number insert your personal  registration
  119.  number in the DIZMAN.CFG (see RegCode).
  120.  
  121.  If I write a new version of DizMan,  (I suppose I will do so) you do NOT need
  122.  to reregister your current version.
  123.  
  124.  The  registration  number  will  keep all further versions of DizMan running.
  125.  Please write your registration information down on a piece of paper and store
  126.  it in a safe place to avoid trouble.
  127.  
  128. ╔═════════════════════════════════════════════════════════════════════════════╗
  129. ║                             Selling DizMan                                  ║
  130. ╚═════════════════════════════════════════════════════════════════════════════╝
  131.  
  132.  1. I do NOT allow the selling of DizMan via PD/Shareware marketing companies.
  133.     If you want to, you need my written permission.
  134.  
  135.  2. I do not mind if you put the software in your BBS to let other users make
  136.     a download of it.
  137.  
  138.  3. You can also put the software in Shareware-packets (e.g. Mailbox-software)
  139.     without my explicit permission.  However you are not allowed to put it in,
  140.     if you sell the packets via a PD/Shareware marketing company. (see #1)
  141.  
  142.  The things I mentioned in #2 and #3 are only important if we talk about
  143.  the complete archive containing the following files :
  144.                                                      
  145.     DIZMAN.EXE    The executable program.
  146.     DIZMAN.DIR    An example of a DirList-file.
  147.     DIZMAN.DOC    The english document file. (This file)
  148.     DIZMAN.DOK    The german document file.
  149.     DIZMAN.CFG    An example of a configuration-file.
  150.     FILE_ID.DIZ   The short description of DizMan.
  151.     FILE_ID.DOC   A short description of the FILE_ID.DIZ format.
  152.  
  153. ╔═════════════════════════════════════════════════════════════════════════════╗
  154. ║                      How to configure DizMan?                               ║
  155. ╚═════════════════════════════════════════════════════════════════════════════╝
  156.  
  157.              Create a text config file (best use DIZMAN.CFG)... >8)
  158.  
  159. DizMan understands the following keywords:
  160.  
  161. ┌─────────────────────────────────────────────────────────────────────────────┐
  162. │ Register                                                                    │
  163. └─────────────────────────────────────────────────────────────────────────────┘
  164.  
  165.  Starts a REGISTER frame to define your name and regcode.
  166.  
  167. ┌─────────────────────────────────────────────────────────────────────────────┐
  168. │ RegName <string>                                                            │
  169. └─────────────────────────────────────────────────────────────────────────────┘
  170.  
  171.  Defines the name DizMan is registered to.
  172.  
  173. ┌─────────────────────────────────────────────────────────────────────────────┐
  174. │ BbsName <string>                                                            │
  175. └─────────────────────────────────────────────────────────────────────────────┘
  176.  
  177.  Defines the bbs DizMan is registered to.
  178.  
  179. ┌─────────────────────────────────────────────────────────────────────────────┐
  180. │ RegCode <string>                                                            │
  181. └─────────────────────────────────────────────────────────────────────────────┘
  182.  
  183.  Defines the registration code.
  184.  
  185. ┌─────────────────────────────────────────────────────────────────────────────┐
  186. │ End Register                                                                │
  187. └─────────────────────────────────────────────────────────────────────────────┘
  188.  
  189.  Closes a REGISTER frame.
  190.  
  191. ┌─────────────────────────────────────────────────────────────────────────────┐
  192. │ Settings                                                                    │
  193. └─────────────────────────────────────────────────────────────────────────────┘
  194.  
  195.  Starts a SETTINGS frame to define the default settings.
  196.  
  197. ┌─────────────────────────────────────────────────────────────────────────────┐
  198. │ TempDir <path>                                                              │
  199. └─────────────────────────────────────────────────────────────────────────────┘
  200.  
  201.  The TempDir keyword defines a directory for DizMan's temporary files.
  202.  
  203. ┌─────────────────────────────────────────────────────────────────────────────┐
  204. │ DirList <filename>                                                          │
  205. └─────────────────────────────────────────────────────────────────────────────┘
  206.  
  207.  The DirList keyword defines a textfile which defines the directories  and the
  208.  files  DizMan  should work on.  If no DirList is defined you have to define a
  209.  workfile via commandline.
  210.  
  211.  The DirList-file must have the following format:
  212.  
  213.     <path>[<filename>] [@<filename>]
  214.  
  215.  So these entry would be o.k. in the DirList-file:
  216.  
  217.     D:\FILES
  218.     D:\FILES\
  219.     D:\FILES\*.*
  220.     D:\FILES\*.ARJ
  221.     D:\FILES           @D:\LISTS\FILES.BBS
  222.     D:\FILES\          @D:\LISTS\FILES.BBS
  223.     D:\FILES\*.*       @D:\LISTS\FILES.BBS
  224.     D:\FILES\*.ARJ     @D:\LISTS\FILES.BBS
  225.  
  226. ┌─────────────────────────────────────────────────────────────────────────────┐
  227. │ LogFile <filename>                                                          │
  228. └─────────────────────────────────────────────────────────────────────────────┘
  229.  
  230.  The LogFile keyword defines a log-file for  DIZMAN.  If you want to establish
  231.  a LOG-FILE, you have to declare it! E.g.:
  232.  
  233.  LogFile          C:\DIZMAN\DIZMAN.LOG
  234.  
  235. ┌─────────────────────────────────────────────────────────────────────────────┐
  236. │ SwapFile <filename>                                                         │
  237. └─────────────────────────────────────────────────────────────────────────────┘
  238.  
  239.  The  SwapFile keyword defines a swap-file that DIZMAN uses if it can not swap
  240.  into EMS.
  241.  
  242.  SwapFile         C:\DIZMAN\DIZMAN.$$$
  243.  
  244. ┌─────────────────────────────────────────────────────────────────────────────┐
  245. │ SaveFilesBbsExt <file-extension>                                            │
  246. └─────────────────────────────────────────────────────────────────────────────┘
  247.  
  248.  SaveFilesBbsExt defines  the extension of the files.bbs backup file.  Default
  249.  extension is BAK
  250.  
  251. ┌─────────────────────────────────────────────────────────────────────────────┐
  252. │ ProcessLastDays <number>                                                    │
  253. └─────────────────────────────────────────────────────────────────────────────┘
  254.  
  255.  The ProcessLastDays keyword defines which files should be processed.  If only
  256.  files younger  than x days  should be processed set ProcessLastDays to x.  If
  257.  all files should be processed set 0. Default: 0. Range: 0-100.
  258.  
  259. ┌─────────────────────────────────────────────────────────────────────────────┐
  260. │ AddOrphan                                                                   │
  261. └─────────────────────────────────────────────────────────────────────────────┘
  262.  
  263.  The AddOrphan keyword  instructs  DizMan  to add to the FILES.BBS (or equiva-
  264.  lent) any file that was processed and was not listed in FILES.BBS already.
  265.  
  266. ┌─────────────────────────────────────────────────────────────────────────────┐
  267. │ OrphanDesc <string>                                                         │
  268. └─────────────────────────────────────────────────────────────────────────────┘
  269.  
  270.  The OrphanDesc keyword instructs  DizMan  to add a special description to the
  271.  FILES.BBS (or equivalent) for  any file that was processed and was not listed
  272.  in FILES.BBS already.
  273.  
  274. ┌─────────────────────────────────────────────────────────────────────────────┐
  275. │ Ignore <filename>                                                           │
  276. └─────────────────────────────────────────────────────────────────────────────┘
  277.  
  278.  The Ignore keyword  instructs  DizMan  to ignore all files with the specified
  279.  name. You are allowed up to 50 filename!
  280.  
  281. ┌─────────────────────────────────────────────────────────────────────────────┐
  282. │ DizName <filename>                                                          │
  283. └─────────────────────────────────────────────────────────────────────────────┘
  284.  
  285.  The  DizName  keyword defines filenames of  FILE_ID.DIZ  like files.  You can
  286.  define up to 10 DizNames. No WildCards!
  287.  
  288. ┌─────────────────────────────────────────────────────────────────────────────┐
  289. │ CutDiz <number>                                                             │
  290. └─────────────────────────────────────────────────────────────────────────────┘
  291.  
  292.  The CutDiz  keyword  defines where to shorten the  FILE_ID.DIZ.  A value of x
  293.  will shorten the FILE_ID.DIZ to x letters on each line.  If e.g. filedescrip-
  294.  tion starts with column 35, you should set CutDiz to 45.
  295.  Default: 45. Range: 0-255 (0 = No cut).
  296.  
  297. ┌─────────────────────────────────────────────────────────────────────────────┐
  298. │ NoLongDesc                                                                  │
  299. └─────────────────────────────────────────────────────────────────────────────┘
  300.  
  301.  The  NoLongDesc  keyword is used if you want the description all in one line.
  302.  Please note:  The  automatic  line-handling of the  most bbs's may cause some
  303.  garbage then! Default: off
  304.  
  305. ┌─────────────────────────────────────────────────────────────────────────────┐
  306. │ BeginLongDesc <number>                                                      │
  307. └─────────────────────────────────────────────────────────────────────────────┘
  308.  
  309.  The  BeginLongDesc  keyword is used if the long file-description should begin
  310.  at a special column. Default: 1. Range: 1-255.
  311.  
  312. ┌─────────────────────────────────────────────────────────────────────────────┐
  313. │ LongDescStartStr <string>                                                   │
  314. └─────────────────────────────────────────────────────────────────────────────┘
  315.  
  316.  If you want a special sign on each line of a long description you can use the
  317.  LongDescStartStr keyword. Default: No StartStr
  318.  
  319. ┌─────────────────────────────────────────────────────────────────────────────┐
  320. │ KillHiAscii                                                                 │
  321. └─────────────────────────────────────────────────────────────────────────────┘
  322.  
  323.  The KillHiAscii keyword instructs DIZMAN to replace all HiAscii's ( > 127) in
  324.  the FILE_ID.DIZ with Blanks (Ascii 32). Default: off.
  325.  
  326. ┌─────────────────────────────────────────────────────────────────────────────┐
  327. │ KillMultiBlanks                                                             │
  328. └─────────────────────────────────────────────────────────────────────────────┘
  329.  
  330.  If KillHiAscii and NoLongDesc is on,  it KillMultiBlanks should be on!  If it
  331.  is on all 'long spaces'  (a string of ASCII #32)  in the description  will be
  332.  converted to a 'short space' (only one ASCII #32). This does only work if the
  333.  NoLongDesc is on! Default: Off.
  334.  
  335. ┌─────────────────────────────────────────────────────────────────────────────┐
  336. │ MaxDizLines <number>                                                        │
  337. └─────────────────────────────────────────────────────────────────────────────┘
  338.  
  339.  The  MaxDizLines  keyword tells DIZMAN how many lines of the FILE_ID.DIZ file
  340.  it should use for its Descriptions. Range: 0-255. Default: 255.
  341.  
  342. ┌─────────────────────────────────────────────────────────────────────────────┐
  343. │ SaveFirstDescLine                                                           │
  344. └─────────────────────────────────────────────────────────────────────────────┘
  345.  
  346.  SaveFirstDescLine  tells DIZMAN to adopt the first of the old description for
  347.  the new description.  This works only if NoLongDesc is off!  It works only if
  348.  DIZMAN imports a FILE_ID.DIZ description! Default: off.
  349.  
  350. ┌─────────────────────────────────────────────────────────────────────────────┐
  351. │ ShowDlTime <string>                                                         │
  352. └─────────────────────────────────────────────────────────────────────────────┘
  353.  
  354.  With ShowDlTime you can instruct DIZMAN to insert a line with the DL duration
  355.  for some baudrates. You can use the following tags:
  356.  
  357.    %bx    - to define the baudrate (x = baudrate)
  358.    %h     - force display of hours
  359.    %m     - force display of minutes
  360.    %s     - force display of seconds
  361.  
  362.  Example:   ShowDlTime %b2400bps %h:%m:%s * %b14400bps %h:%m:%s
  363.  
  364.             Would insert a line like this:
  365.  
  366.             2400bps 00:17:29 * 14400bps 00:02:54
  367.  
  368.  By default DIZMAN will not show a DL time-info!  ShowDlTime works only if the
  369.  NoLongDesc keyword is not set.
  370.  
  371. ┌─────────────────────────────────────────────────────────────────────────────┐
  372. │ CounterStyle <char><char>                                                   │
  373. └─────────────────────────────────────────────────────────────────────────────┘
  374.  
  375.  The CounterStyle keyword specifies which counter delimiter to use. Default []
  376.  
  377. ┌─────────────────────────────────────────────────────────────────────────────┐
  378. │ CounterLength <number>                                                      │
  379. └─────────────────────────────────────────────────────────────────────────────┘
  380.  
  381.  The CounterLength keyword tells DizMan how many digits to use in the counter.
  382.  If you specify 4,  then  there  will be 4 characters between the  delimiters.
  383.  Numbers  will  NOT  be zero padded however,  they will be space padded on the
  384.  left, ie. [   1].  Default: 0. Range: 0-10 (0 = No counters).
  385.  
  386. ┌─────────────────────────────────────────────────────────────────────────────┐
  387. │ SpaceForZero                                                                │
  388. └─────────────────────────────────────────────────────────────────────────────┘
  389.  
  390.  The  SpaceForZero  keyword instructs  DizMan  to use a space for a zero count
  391.  instead of a zero. That is,  DizMan will insert a [    ] instead of a [   0].
  392.  The default is to use a zero instead of a space.
  393.  
  394. ┌─────────────────────────────────────────────────────────────────────────────┐
  395. │ ZeroPadded                                                                  │
  396. └─────────────────────────────────────────────────────────────────────────────┘
  397.  
  398.  The ZeroPadded keyword instructs  DizMan  to padd counters with zeros instead
  399.  of spaces,  ie. [0001] instead of [   1].  This is in effect  when adding new
  400.  counters. The default is to pad with spaces.
  401.  
  402. ┌─────────────────────────────────────────────────────────────────────────────┐
  403. │ End Settings                                                                │
  404. └─────────────────────────────────────────────────────────────────────────────┘
  405.  
  406.  Closes a SETTINGS frame.
  407.  
  408. ┌─────────────────────────────────────────────────────────────────────────────┐
  409. │ Archive                                                                     │
  410. └─────────────────────────────────────────────────────────────────────────────┘
  411.  
  412.  Starts a ARCHIVE frame. You can define up to 50 archives! With the ident-code
  413.  DizMan will check ALL archives  in the same order as they are defined.  So be
  414.  careful: Do not change the order of ARC/PAK/HYP with the default ident codes!
  415.  
  416. ┌─────────────────────────────────────────────────────────────────────────────┐
  417. │ ArcName <packername>                                                        │
  418. └─────────────────────────────────────────────────────────────────────────────┘
  419.  
  420.  The ARCNAME keyword tells DizMan the name of the Archiver
  421.  
  422. ┌─────────────────────────────────────────────────────────────────────────────┐
  423. │ Ident <offset>,<hex-string>                                                 │
  424. └─────────────────────────────────────────────────────────────────────────────┘
  425.  
  426.  Unless you are familiar with the internals of compression programs, the IDENT
  427.  keyword  (see below)  should not be modified. Two numbers follow the keyword,
  428.  each  separated by a comma.  When attempting to  decompress  an archive of an
  429.  unknown type,  DizMan  will use  this information to  automatically  identify
  430.  different types of archives.
  431.  
  432.  The first number after IDENT contains the OFFSET at which a special identify-
  433.  ing marker  can be  located.  Positive entries  work in  the expected manner,
  434.  whereas  negative entries can be  used to  indicate offsets from the END of a
  435.  compressed file.  However,  an offset  of "-1" is the LAST character,  and an
  436.  offset of "-2" the SECOND-LAST character, etc.
  437.  
  438.  Following the  OFFSET  is a series of hexadecimal numbers which represent the
  439.  text which can be found at the specified offset in the compressed file.  Each
  440.  byte in the compressed file should be represented by the appropriate  hexade-
  441.  cimal character. For example, an uppercase 'A' can be represented with a '41'
  442.  which is  the ASCII code for 'A' (in hexadecimal).  Strings of characters may
  443.  also be recognized by simply specifying more than one sequence of bytes.
  444.  
  445. ┌─────────────────────────────────────────────────────────────────────────────┐
  446. │ Command <commandline>                                                       │
  447. └─────────────────────────────────────────────────────────────────────────────┘
  448.  
  449.  The COMMAND keyword tells DizMan how to unpack compressed files of the speci-
  450.  fied type. "%a" will be translated to the name of the archive,  and "%f" will
  451.  be translated to the name of the file to extract.
  452.  
  453.  A '*' as first char after COMMAND indicates that the COMMAND  keyword is used
  454.  as  a  description  style  definition.  You can use the following tags in the
  455.  COMMAND definition:
  456.                                                                                                             │
  457.    %bx    = patches the byte value at offset 'x' in the current workfile
  458.             into the description.
  459.    %d     = description found in files.bbs
  460.    %e+a,b = will be replaced by the result of 'a + b'
  461.    %e-a,b = will be replaced by the result of 'a - b'
  462.    %e*a,b = will be replaced by the result of 'a * b'
  463.    %e/a,b = will be replaced by the result of 'a DIV b'
  464.    %e&a,b = will be replaced by the result of 'a AND b'
  465.    %e<a,b = will be replaced by the result of 'a SHL b'
  466.    %e>a,b = will be replaced by the result of 'a SHR b'
  467.    %fa    = searches  in the archive for string 'a' and will be replaced
  468.             by the offset of the first a found in the archive.  'a' must
  469.             be a hex-string!
  470.    %sx,y  = patches a string with a length of y characters starting from
  471.             the offset 'x' in the current workfile into the description.
  472.    %wlhx  = patches the word value at offset 'x' in the current workfile
  473.             into the description. (lower byte first!)
  474.    %whlx  = patches the word value at offset 'x' in the current workfile
  475.             into the description. (lower byte last!)
  476.  
  477.  Note: The difference between %whl and %wlh is the following: If a file starts
  478.  with a hex-string of '12 34 D4 FF ...' the tag %wlh0 would translate 3412h to
  479.  '13330' and %whl0 would translate 1234h to '4660'.
  480.  
  481. ┌─────────────────────────────────────────────────────────────────────────────┐
  482. │ End Archive                                                                 │
  483. └─────────────────────────────────────────────────────────────────────────────┘
  484.  
  485.  Closes a ARCHIVE frame.
  486.  
  487. ╔═════════════════════════════════════════════════════════════════════════════╗
  488. ║                              Running DizMan                                 ║
  489. ╚═════════════════════════════════════════════════════════════════════════════╝
  490.  
  491.    Syntax:
  492.  
  493.         DIZMAN.EXE <filename> [options]
  494.  
  495.    Currently DizMan knows the following options:
  496.  
  497.         /?                Request commandline help.
  498.  
  499.         /C<filename>      Which configfile to use. DIZMAN.CFG is default.
  500.  
  501.         /F<filename>      Which file to use as a FILES.BBS.
  502.  
  503.    Examples:
  504.  
  505.         DIZMAN.EXE *.*
  506.  
  507.         DIZMAN.EXE TEST.A?? /CC:\BBS\DIZMAN\DIZMAN.CFG
  508.  
  509.         DIZMAN.EXE F:\MSDOS\*.* /FC:\CD1\MSDOS.BBS
  510.  
  511. ╔═════════════════════════════════════════════════════════════════════════════╗
  512. ║                               Revision History                              ║
  513. ╚═════════════════════════════════════════════════════════════════════════════╝
  514.  
  515.         1.20 - New: Enhanced all  'special commands'  and added the %e
  516.                and the %f tag.
  517.  
  518.                New: Added support for PCX and JPG without HSI header.
  519.  
  520.                New: Now DizMan can also insert the 'number of colours'
  521.                for all graphic-formats (except SCX - I don't now where
  522.                to get the colour-information ;-)
  523.  
  524.         1.11 - New: Converted the 'special command' tag %w to %wlh and
  525.                added the %whl tag.
  526.  
  527.                New: Added BMP/JPG/LBM/MAC/MSP/PIC/RLE/SCX support.
  528.  
  529.         1.10 - New: DizMan has a new outfit.  Now you can see what ex-
  530.                ternal programs like ARJ etc do.
  531.  
  532.                New: Now DizMan calls external programs directly. There
  533.                is now  more  memory  for the external programs because
  534.                COMMAND.COM is no longer loaded.
  535.  
  536.                New: Now DizMan can swap to EMS/Disk to give the exter-
  537.                nal programs a maximum of space ( DizMan  will only use
  538.                about 30K)! See also SWAPFILE.
  539.  
  540.                New: DizMan now recognizes 8 new formats (S3M, ARJ SFX,
  541.                LHA SFX, PAK SFX, ZIP SFX).
  542.  
  543.                New: Added the KillMultiBlanks  keyword for better sup-
  544.                port of singleline descriptions (NoLongDesc).
  545.  
  546.                BugFix: Now  DizMan inserts a blank (#32) at the end of
  547.                a FILE_ID.DIZ line if you use NoLongDesc.
  548.  
  549.         1.01 - Modified  the sample configuration and added support of
  550.                the HA and HAP&PAH packer.
  551.  
  552.              - New:  Added a german documentation to the  distribution
  553.                archiv.
  554.  
  555.              - New: Added the LogFile keyword to define a logfile.
  556.  
  557.              - New: Added the DirList support.
  558.  
  559.              - New: If KillHiAscii is on  Ä, Ö, Ü, ä, ö, ü, ß  will be
  560.                translated to  Ae, Oe, Ue, ae, oe, ue, ss!
  561.  
  562.              - BugFix: If SaveFirstDescLine was set and DizMan found a
  563.                FILE_ID.DIZ  with an  empty first line the old descrip-
  564.                tion was lost in space.
  565.  
  566.              - BugFix: If  SaveFirstDescLine  and KillHiAscii  was set
  567.                and  the old description was the same as the first non-
  568.                empty  FILE_ID.DIZ  line  (after HiAscii's were killed)
  569.                the description line was doubled.
  570.  
  571.              - BugFix: If DizMan was  aborted by an error it sometimes
  572.                did not reset the directory to the startup directory.
  573.  
  574.              - BugFix: Fixed some sharing-problems.
  575.  
  576.              - BugFix: If a file was listed in the FILES.BBS and there
  577.                was an empty line after the description, the empty line
  578.                disapeared after inserting a FILE_ID.DIZ comment.
  579.  
  580.              - Some smaller internal changes.
  581.  
  582.         1.00 - Base version.  (Turbo Pascal 6.0)
  583.  
  584. ╔═════════════════════════════════════════════════════════════════════════════╗
  585. ║                                    Thanks                                   ║
  586. ╚═════════════════════════════════════════════════════════════════════════════╝
  587.  
  588.     Thanks to:
  589.  
  590.         - Johan Zwiekhorst for the excellent GUS (General Unpack Shell)
  591.           Documentation!
  592.  
  593.         - Martin Austermeier for his ideas in the DOSWIN module.
  594.  
  595.         - Kim Kokkonen for his article in Dr. Dobbs Journal 4/1988.
  596.  
  597.         - Anders Danielsson for his Repack program.
  598.  
  599.         - Thomas Mainka for the ADIR documentation.
  600.  
  601. ╔═════════════════════════════════════════════════════════════════════════════╗
  602. ║         Documentation for DizMan v1.20, written 1993 by Stefan Kuhn.        ║
  603. ╚═════════════════════════════════════════════════════════════════════════════╝
  604.